home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / fgetchar.txt < prev    next >
Text File  |  1992-03-24  |  2KB  |  64 lines
  1. Fgetchar(2)               Oct. 1, 1991                Fgetchar(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Fgetchar - read a character from a file
  7.  
  8. SYNOPSIS
  9.      LONG Fgetchar( WORD fh, WORD mode );
  10.  
  11. DESCRIPTION
  12.      Fgetchar reads a character from the open file  whose  handle
  13.      is  fh.   The  parameter mode has an effect only if the open
  14.      file is a terminal or pseudo-terminal,  in  which  case  the
  15.      bits of mode have the following meanings:
  16.  
  17.      0x0001
  18.           Cooked mode; special control characters (control-C  and
  19.           control-Z)  are  checked  for  and interpreted if found
  20.           (they cause SIGINT and  SIGTSTP,  respectively,  to  be
  21.           raised);   also,   flow   control  with  control-S  and
  22.           control-Q is activated.
  23.  
  24.      0x0002
  25.           Echo mode; characters read are echoed back to the  ter-
  26.           minal.
  27.  
  28.      The ASCII value of the character read is put in the low byte
  29.      of the long word that is returned. If the file is a terminal
  30.      or pseudo-terminal, the scan code of the  character  pressed
  31.      and (possibly) the shift key status are also returned in the
  32.      long word, just as with the BIOS Bconin system call.
  33.  
  34. RETURNS
  35.      The character read, if successful.
  36.  
  37.      0x0000FF1A if end of file is detected.
  38.  
  39.      EIHNDL if fh is not a valid handle for an open file.
  40.  
  41. SEE ALSO
  42.      Bconin(2), Cconin(2), Cauxin(2), Fputchar(2), Fread(2)
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.9   Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.